package com.ruoyi.system.mapper;

import com.ruoyi.system.domain.UserMedal;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 用户勋章Mapper接口
 *
 * @author ruoyi
 * @date 2025-04-17
 */
public interface UserMedalMapper {
    /**
     * 查询用户勋章
     *
     * @param id 用户勋章主键
     * @return 用户勋章
     */
    UserMedal selectUserMedalById(Long id);

    /**
     * 查询用户勋章列表
     *
     * @param userMedal 用户勋章
     * @return 用户勋章集合
     */
    List<UserMedal> selectUserMedalList(UserMedal userMedal);

    /**
     * 新增用户勋章
     *
     * @param userMedal 用户勋章
     * @return 结果
     */
    int insertUserMedal(UserMedal userMedal);

    /**
     * 修改用户勋章
     *
     * @param userMedal 用户勋章
     * @return 结果
     */
    int updateUserMedal(UserMedal userMedal);

    /**
     * 删除用户勋章
     *
     * @param id 用户勋章主键
     * @return 结果
     */
    int deleteUserMedalById(Long id);

    /**
     * 批量删除用户勋章
     *
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    int deleteUserMedalByIds(Long[] ids);

    /**
     * 查询用户拥有的勋章
     *
     * @param userId 用户ID
     * @return 用户拥有的勋章列表
     */
    List<UserMedal> selectUserMedalsByUserId(Long userId);

    /**
     * 检查用户是否已经拥有某个勋章
     *
     * @param userId 用户ID
     * @param medalId 勋章ID
     * @return 若存在返回 1，不存在返回 0
     */
    int checkUserHasMedal(@Param("userId") Long userId, @Param("medalId") Long medalId);}